home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / dl_serie / 109 / doku / zm_modul.txt < prev   
Encoding:
Text File  |  1994-09-25  |  61.7 KB  |  1,826 lines
  1. 'Zeig's mir'-Modulanleitung                                Allgemeines
  2. ----------------------------------------------------------------------
  3.  
  4. Diese Beschreibung dokumentiert den Stand der Modulentwicklung
  5. am 17.8.94. Zum Zeitpunkt der Veröffentlichung dieses Textes hat
  6. es bei den Versionsnummern und beim Funktionsumfang sehr
  7. wahrscheinlichund schon wieder Änderungen gegeben, vielleicht ist
  8. sogar das ein oder andere Modul zusätzlich vorhanden.
  9.  
  10. Die Module stammen von verschiedenen Autoren, die die Nutzung
  11. der Module selbst oder der Sourcecodes zu unterschiedlichen
  12. Konditionen erlauben. Allen Modulen gemein ist, daß sie zusammen
  13. mit 'Zeig's mir' frei verbreitet und zum privaten Gebrauch mit
  14. 'Zeig's mir' unentgeltlich benutzt werden dürfen.
  15.  
  16. Eine Bitte vom Programmautor von 'Zeig's mir': Die Autoren von
  17. Modulen haben ihr Honorar bisher nur in der Form erhalten, daß
  18. ich alle paar Wochen die Modulschnittstelle geändert und ihnen
  19. damit neue Arbeit verschafft habe. Insbesondere was die
  20. Verarbeitung von Farbbildern angeht, steckt ein Großteil der
  21. Leistungsfähigkeit von 'Zeig's mir' in den Importmodulen von
  22. Dirk und John sowie Thorstens fabulösem Ditherer. Den Freunden
  23. bunter Bilder sei deshalb besonders ans Herz gelegt, die Modul-
  24. autoren bei der Registrierung zusätzlich mit einer kleinen Spende
  25. zu bedenken (schlimm, diese Bettelorgien, ich weiß!).
  26.  
  27. Die in dieser Anleitung mehrfach erwähnten Modulsourcen sind in
  28. der Vertriebsversion von 'Zeig's mir' aus Platzgründen nicht
  29. enthalten, sondern nur im Entwicklerarchiv zu 'Zeig's mir'.
  30.  
  31.  
  32.                                                Module (c) by Dirk Haun
  33. ----------------------------------------------------------------------
  34.  
  35. BRIGHTEN.MDL  -> Bearbeitungsmodul(Farbbild) Helligkeit
  36.                  von Bildern ändern
  37.  
  38. GIF.MDL/
  39. ASCGIF.MDL    -> Importmodul(Farbbilder) für GIF-Bilder
  40.  
  41. FLI.MDL       -> Importmodul(Farbbilder) für FLI/FLC-Animationen
  42.  
  43. HTDITHER.MDL  -> Dithermodul, Halbtonalgorithmus
  44.  
  45. ICO.MDL       -> Importmodul(Farbbilder) für Windows-Icons
  46.  
  47. NOBORDER.MDL  -> Bearbeitungsmodul(Farbbilder) zum Abscneiden von
  48.                  Bildrändern
  49.  
  50. REDUCE.MDL    -> Dithermodul, Reduzierer für 256 Farben
  51.  
  52. SOUNDEXP.MDL  -> Exportmodul(Sound) für HSN-Samples
  53.  
  54. TARGA.MDL     -> Importmodul(Farbbilder) für das Targa-Format
  55.  
  56. TARGAEXP.MDL  -> Exportmodul(Farbbilder) für Targa-Bilder
  57.  
  58. TSWS.MDL      -> Importmodul für Dirks eigenes Infofileformat
  59.  
  60. XIMG.MDL      -> Importmodul(Farbbilder) für XIMG-Bilder
  61.  
  62. ZEIGSND.MDL   -> Importmodul(Sound) für diverse Formate
  63.  
  64. ZEIGDOC.MDL   -> Importmodul(Text) für Wordplus-Dokumente
  65.  
  66.  
  67. Diese Module sind Freeware, ebenso wie die bei den meisten
  68. Modulen mitgelieferten Sourcen.
  69.  
  70. Der Autor dieser Module kann auf folgenden Wegen erreicht werden:
  71.  
  72.  per Sackpost
  73.  
  74.         Dirk Haun
  75.         Europastr. 8
  76.         64569 Nauheim
  77.  
  78.  per e-mail
  79.  
  80.         Dirk Haun @ WI2 (MausNet)
  81.  
  82.  
  83. Literaturempfehlung
  84.  
  85.    "Computer Graphics - Principles and Practice"
  86.    Foley, van Dam, Feiner, Hughes
  87.    Addison-Wesley, 1990
  88.    ISBN  0-201-12110-7
  89.  
  90.  
  91. Standard-Disclaimer
  92.  
  93. Diese Module erfüllen bei mir ihren Zweck, was aber nicht heißt,
  94. daß sie das  überall  tun.  Sollte eines dieser Module daher etwas
  95. unvorgesehenes anrichten, so kann ich für die dadurch entstandenen
  96. Schäden (was  auch  immer das sein  sollte)  nicht haftbar gemacht
  97. werden - die Benutzung erfolgt auf eigene Gefahr.
  98.  
  99. Zudem  möchte ich darauf hinweisen,  daß ich in keinster Weise mit
  100. oder  am  Addison-Wesley-Verlag  verwandt  oder  beteiligt bin und
  101. obiges Buch nur deshalb immer wieder erwähne,  weil ich es einfach
  102. gut finde :-)
  103.  
  104.  
  105.                                              Module (c) by John McLoud
  106. ----------------------------------------------------------------------
  107.  
  108. IFF.MDL     -> Importmodul(Farbbilder) für das IFF-Format
  109.  
  110. PCX.MDL     -> Importmodul(Farbbilder) für das PCX-Format
  111.  
  112. JPEG.MDL    -> Importmodul(Farbbilder) für das JPEG-Format
  113.  
  114. TIFF.MDL    -> Importmodul(Farbbilder) für das TIFF-Format
  115.  
  116.  
  117. Kontaktadresse
  118.  
  119. Der Modulautor ist folgendermaßen erreichbar:
  120.  
  121.  per Brief/Paketpost
  122.  
  123.    John McLoud
  124.    Mozartstraße 1a
  125.    65439 Flörsheim am Main
  126.  
  127.  per e-mail
  128.  
  129.    John Mcloud @ WI2 (MausNet)
  130.  
  131.  
  132. Standard-Disclaimer
  133.  
  134. Ein nicht näher benannter Bekannter würder sagen "Bei mir
  135. funktioniert's". Wenn nicht, bitte ich um einen, möglichst
  136. genauen, Bugreport (ein Beispielbild ist immer ne gute Hilfe).
  137.  
  138. Die Benutzung der Module dürfte eigentlich keinerlei Schäden
  139. verursachen, wenn doch, Pech gehabt. Haftung übernehme ich in
  140. keiner Weise. Dafür ist die Verwendung kostenlos.
  141.  
  142.  
  143.  
  144.                                        Module (c) by Thorsten Pohlmann
  145. ----------------------------------------------------------------------
  146.  
  147. ADPCM.MDL    -> Importmodul(Sound): ZyXEL Voice-Files *.ZY2,*.ZY3
  148.                 nach 8-Bit-signed Sound
  149.  
  150. BMPMAN.MDL   -> Importmodul(Grafik) für ungepackte _Windows_-BMPs
  151.  
  152. BW256.MDL    -> Importmodul(Grafik) für B&W Graustufenbilder
  153.  
  154. CHAINSAW.MDL -> Bearbeitungsmodul(Text): Zeilenumbruch
  155.  
  156. IGOR_DIT.MDL -> Reduziermodul(Grafik): TC/HC -> 256/16 Farben
  157.                 dithern TC/HC -> 256 Farben mappen, s/w dithern
  158.  
  159. KOMPRESS.MDL -> Bearbeitungsmodul(Sound): Lautstärkekompressor
  160.  
  161. NEOMOD.MDL   -> Importmodul(Grafik): Neochromebilder
  162.  
  163. TABSPACE.MDL -> Bearbeitungsmodul(Text):Tabs aus Texten entfernen
  164.  
  165.  
  166. Die Module sind 'Feuerware', d.h. wer sie mag und ohne sie
  167. nicht mehr leben kann, soll bei seiner 'Zeig's mir'-Registrierung
  168. zwei DM (in Worten 'zwei') mehr an Reiner Rosin Überweisen. Damit
  169. wird dann beim nächsten Maustreff mein Durst gelöscht, wenn genug
  170. zusammenkommt. Hoffe ich. Bitte auf der Überweisung vermerken!
  171.  
  172.  
  173. Diese Module dürfen/sollen ohne Änderungen weitergegeben werden.
  174. Sie dürfen anderen 'Zeig's mir'-Modulen in dieser Form beigelegt
  175. werden, sofern für sie kein Betrag >3 DM verlangt wird.
  176. Die Sourcen sind so verquirlt, dass wer da durchblickt sie auch
  177. (nichtkommerziell) benutzen darf.
  178.  
  179. Flames, Anregungen für _diese, meine_ Module etc. bitte _nicht_
  180. an Reiner Rosin, sondern direkt an mich:
  181.  
  182.         email: Thorsten Pohlmann@WI2.maus.de
  183.             o. 2:244/2113.8 (FIDO)
  184.  
  185.        Thorsten Pohlmann
  186.        Frauensteinerstr. 15
  187.        65199 Wiesbaden
  188.  
  189.  
  190.                                             Module (c) by Reiner Rosin
  191. ----------------------------------------------------------------------
  192.  
  193. BITMAP.MDL    -> Bearbeitungsmodul(Grafik): Halbieren/Verdoppeln
  194.                  von Monochrombildern
  195.  
  196. COL_FUNC.MDL  -> Bearbeitungsmodul(Farbbild): Farbbild verdoppeln
  197.  
  198. COL_INFO.MDL  -> Bearbeitungsmodul(Farbbild): Farben zählen
  199.  
  200. ELIMINAT.MDL  -> Dithermodul(Grafik): Farbreduktion
  201.  
  202. FAX300.MDL    -> Bearbeitungsmodul(Grafik): Fax-Aufbereitung
  203.  
  204. GDPSSCAN.MDL  -> Sourcemodul(Grafik): Scannen per GDPS-Treiber
  205.  
  206. GREP.MDL      -> Bearbeitungsmodul(Text): Textteile suchen
  207.  
  208. INVERTER.MDL  -> Bearbeitungsmodul(Grafik): Bilder invertieren
  209.  
  210. MAULWURF.MDL  -> Bearbeitungsmodul(Farbbild): Rot-Grün tauschen
  211.  
  212. MED_CUT.MDL   -> Dithermodul (Grafik): Median-Cut-Algorithmus
  213.  
  214. PAL_SORT.MDL  -> Dithermodul (Grafik): Palettensortierung
  215.  
  216. PIC2ASC.MDL   -> Bearbeitungsmodul(Farbbild): Bild->ASCII wandeln
  217.  
  218. PIC_CUT.MDL   -> Bearbeitungsmodul(Grafik): Bildrand wegschneiden
  219.  
  220. PIC_DBL.MDL   -> Bearbeitungsmodul(Grafik): Bild verdoppeln
  221.  
  222. PIC_TURN.MDL  -> Bearbeitungsmodul(Grafik): Bilder drehen
  223.  
  224. RAMBO.MDL     -> Dithermodul(Grafik): Farbreduktion
  225.  
  226. SAMPCALC.MDL  -> Bearbeitungsmodul(Sound): Sample verstärken
  227.  
  228. SAMPMIRR.MDL  -> Bearbeitungsmodul(Sound): Sample rückwärts
  229.                  abspielen
  230.  
  231. SRC_DMAS.MDL  -> Sourcemodul(Sound): DMA-Sound auslesen
  232.  
  233. SRC_SCRN.MDL  -> Sourcemodul(Grafik): Bildschirm kopieren
  234.  
  235. TINYDITH.MDL  -> Dithermodul(Grafik): verschiedene Ditherer
  236.  
  237. UML_WAND.MDL  -> Bearbeitungsmodul(Text): Umlautwandler
  238.  
  239. ZEIGBLK.MDL   -> Importmodul(Grafik) für GFA-Basic-GET-Blöcke
  240.  
  241. ZEIGFNT.MDL   -> Importmodul(Grafik) für GEM-Fonts
  242.  
  243. ZEIGPIC.MDL   -> Importmodul(Grafik) für Doodle-Bilder (32K)
  244.  
  245. ZEIGZYX.MDL   -> Importmodul(Sound) für ZyXel-Voicefiles
  246.  
  247.  
  248. Meine Module sind zur ausschließlichen Verwendung in 'Zeig's mir'
  249. freigegeben. Der Sourcecode der Module, von denen ich diesen
  250. veröffentlicht habe, darf nichtkommerziell verwendet werden, wenn
  251. in den darauf basierenden Sourcecodes oder Programmen ein Hinweis
  252. auf die Originalquelle enthalten ist.
  253.  
  254.  
  255. Mich kann man erreichen unter:
  256.  
  257.         Rosin Datentechnik
  258.         Reiner Rosin
  259.         Peter-Spahn-Str. 4
  260.         D-65375 Oestrich-Winkel
  261.         Telefon 06723 4978  Fax 7190
  262.  
  263.         email Reiner Rosin @ WI2 (MausNet)
  264.               Reiner_Rosin@wi2.maus.de
  265.                                                              ADPCM.MDL
  266. ----------------------------------------------------------------------
  267.  
  268. Modulname:     ADPCM.MDL
  269. Modulkennung:  ADPCM
  270. Modultyp:      Importmodul
  271. Autor:         (C) Toastware
  272. Versionsnr:    00.02
  273. Versionsdatum: Aug  9 1994
  274.  
  275.  
  276. Importmodul(Sound): ZyXEL Voice-Files *.ZY2,*.ZY3
  277.                     nach 8-Bit-signed Sound
  278.  
  279. Beschreibung
  280.  
  281. Verhilft 'Zeig's mir' dazu, auch Zyxel-Voicefiles (*.ZYX) laden
  282. zu können. Die CELP-Kompression wird noch nicht unterstützt, aber
  283. die Codierung nach ADPCM2 und ADPCM3 (verbreitetstes Format).
  284.  
  285.  
  286.                                                             BMPMAN.MDL
  287. ----------------------------------------------------------------------
  288.  
  289. Modulname:     BMPMAN.MDL
  290. Modulkennung:  BMPMAN
  291. Modultyp:      Importmodul
  292. Autor:         (C) Toastware
  293. Versionsnr:    00.03
  294. Versionsdatum: Aug 18 1994
  295.  
  296.  
  297. Beschreibung
  298.  
  299. Importiert ungepackte 24,8,4,1 Bit Windows(TM) und OS/2(TM)
  300. Bitmaps. Gepackte BMP-Dateien (gibt's die?) werden nicht
  301. unterstützt.
  302.  
  303.                                                              BW256.MDL
  304. ----------------------------------------------------------------------
  305.  
  306. Modulname:     BW256.MDL
  307. Modulkennung:  BW256
  308. Modultyp:      Importmodul
  309. Autor:         (C) Toastware
  310. Versionsnr:    00.01
  311. Versionsdatum: Aug 18 1994
  312.  
  313.  
  314. Beschreibung
  315.  
  316. Importer für GEM-View-Dithermatrizen. Woher dieses Format
  317. ursprünglich herkommt, ist nicht bekannt (wahrscheinlich AIM).
  318.  
  319.  
  320.                                                                FLI.MDL
  321. ----------------------------------------------------------------------
  322.  
  323. Modulname:     FLI.MDL
  324. Modulkennung:  FLIV
  325. Modultyp:      Importmodul
  326. Autor:         Dirk Haun @ WI2, Freeware
  327. Versionsnr:    00.01
  328. Versionsdatum: Jul 24 1994
  329.  
  330.  
  331. Beschreibung
  332.  
  333. Dieses Modul importiert den ersten Frame (d.h. das erste Bild)
  334. einer FLI- oder FLC-Animation als Farbbild in Zeig's mir.
  335.  
  336. Zeig's mir kennt (noch?) keine Animationsmodule, daher ist dies
  337. nur eine einfache Möglichkeit, sich Einblick in die Animation zu
  338. verschaffen. Falls Sie von dem erzeugten Bild enttäuscht sind
  339. (z.B. weil es nur eine einfarbige Fläche oder ein paar Linen
  340. zeigt), so bedenken Sie bitte, daß es sich um eine Animation
  341. handelt, und der interessante Teil möglicherweise erst noch
  342. folgt. Nein, es gibt keine Möglichkeit, die anderen Frames der
  343. Animation auch noch zu Gesicht zu bekommen - zumindest nicht mit
  344. Zeig's mir.
  345.  
  346. Im Infofenster wird außer dem Typ der Animation (nicht alles,
  347. was FLI heißt, ist auch ein FLI) noch die Anzahl der enthaltenen
  348. Frames angegeben.
  349.  
  350.  
  351.                                                                GIF.MDL
  352. ----------------------------------------------------------------------
  353.  
  354. Modulname:     GIF.MDL / ASCGIF.MDL
  355. Modulkennung:  GIFI / GIFA
  356. Modultyp:      Importmodul
  357. Autor:         Dirk Haun @ WI2, Freeware
  358. Versionsnr:    00.30
  359. Versionsdatum: Aug 14 1994
  360.  
  361.  
  362. Beschreibung
  363.  
  364. GIF.MDL importiert Bilder im GIF-Format in Zeig's mir, und zwar
  365. sowohl den verbreitetsten Typ "GIF87a" als auch das weniger
  366. verbreitete "GIF89a". Das Modul ASCGIF importiert die GIF-Bilder
  367. als ASCII-Texte, d.h. die Bilddaten werden so in ASCII-Zeichen
  368. umgesetzt, daß sich (mit etwas Phantasie) der ursprüngliche Bild-
  369. inhalt noch erkennen läßt.
  370.  
  371. Diese Module basieren auf dem Quelltext des Programms ASCGIF von
  372. John Ferrell Jr. (Original) und Oliver Klink (Atari-Version),
  373. daher auch das "Doppelleben" als zwei Module.
  374.  
  375. Anmerkungen:
  376. - Das Modul versucht bei defekten GIFs das Bild noch so weit als
  377.   möglich zu entpacken. Bei einem defekten Bild findet sich im
  378.   Infofenster dann ein entsprechender Hinweis ("Das Bild ist
  379.   offenbar defekt"). Je nach Art des Bildes und des Fehlers kann
  380.   das Ergebnis unter Umständen noch (eingeschränkt) brauchbar
  381.   sein.
  382. - Dieses Modul ist sicher nicht der schnellste GIF-Viewer für
  383.   Ataris, aber auch nicht gerade der langsamste. Ich behaupte
  384.   einfach mal, daß es in C nicht viel schneller geht. Ein
  385.   Umsetzung nach Assembler wäre zwar programmtechnisch reizvoll,
  386.   aber finanziell uninteressant ...
  387.  
  388.  
  389. Hinweis: Man sollte nicht gleichzeitig GIF.MDL und ASCGIF.MDL im
  390. Modulordner stehen haben! Andernfalls wird nämlich, je nach
  391. Reihenfolge in dem Ordner, immer nur eines der beiden Module
  392. verwendet. Man sollte ASCGIF als das betrachten, was es ist: Ein
  393. Gag und ein "Abfallprodukt" des eigentlichen GIF-Importmoduls.
  394. Wer unbedingt Bilder in ASCII-Texte umsetzen lassen will, sollte
  395. das Modul PIC2ASC.MDL von Reiner Rosin verwenden (welches den
  396. Vorteil hat, daß es auch auf andere Bildformate angewendet werden
  397. kann).
  398.  
  399.                                                                ICO.MDL
  400. ----------------------------------------------------------------------
  401.  
  402. Modulname:     ICO.MDL
  403. Modulkennung:  ICOI
  404. Modultyp:      Importmodul
  405. Autor:         Dirk Haun @ WI2, Freeware
  406. Versionsnr:    00.01
  407. Versionsdatum: Jul 24 1994
  408.  
  409.  
  410. Beschreibung
  411.  
  412. Dieses Modul kann Icons, die im Windows-ICO-Format vorliegen, als
  413. Farbbilder in Zeig's mir importieren. Es werden aber nur solche
  414. ICO-Files erkannt, die 32x32 Pixel große Icons mit 16 Farben
  415. enthalten und deren Dateilänge 768 Bytes nicht übersteigt (dies
  416. dürfte aber für die weitaus meisten ICOs zutreffen).
  417.  
  418. Damit man bei einem so kleinen "Bild" überhaupt etwas erkennen
  419. kann, wird das Icon auf das Doppelte (also 64x64 Pixel)
  420. vergrößert.
  421.  
  422.  
  423.                                                                IFF.MDL
  424. ----------------------------------------------------------------------
  425.  
  426. Modulname:     IFF.MDL
  427. Modulkennung:  JIFF
  428. Modultyp:      Importmodul
  429. Autor:         John McLoud, Freeware
  430. Versionsnr:    01.02
  431. Versionsdatum: Aug 14 1994
  432.  
  433.  
  434. Beschreibung
  435.  
  436. IFF.MDL importiert Bilder im IFF-Format in Zeig's mir.
  437.  
  438. Der Importer verarbeitet Palettenbilder mit 2, 4, 16 und 256
  439. Farben. Weiterhin werden HAM und HAM-8 Files als TrueColor-Bilder
  440. importiert.
  441.  
  442.  
  443.  
  444. Anmerkung
  445.  
  446. 24 Bit Bilder finden z.Zt. noch keine Unterstützung, da sich die
  447. AMIGA-Front nicht so ganz einig zu sein scheint, wie man das
  448. implementiert. Um alle möglichen Fälle zu implementieren war ich
  449. definitiv zu bequem (die benötigete Zeit bezahlt leider keiner
  450. und geht über Hobby und Idealismus weit hinaus).
  451.  
  452.  
  453.                                                               JPEG.MDL
  454. ----------------------------------------------------------------------
  455.  
  456. Modulname:     JPEG.MDL
  457. Modulkennung:  JJPG
  458. Modultyp:      Importmodul
  459. Autor:         John McLoud, Freeware
  460. Versionsnr:    01.03
  461. Versionsdatum: Aug 14 1994
  462.  
  463.  
  464. Beschreibung
  465.  
  466. JPEG.MDL importiert Bilder im JPEG-Format in Zeig's mir.
  467.  
  468. Akzeptiert werden Grayscale und TrueColor Bilder gemäß JFIF und
  469. JPEG-RAW Definition.
  470.  
  471.  
  472. Copyright
  473.  
  474. Das Modul basiert auf den Sourcen der "Independent JPEG Group's
  475. software" und unterliegt somit deren Copyright.
  476.  
  477.  
  478.                                                             NEOMOD.MDL
  479. ----------------------------------------------------------------------
  480.  
  481. Modulname:     NEOMOD.MDL
  482. Modulkennung:  NEOMOD
  483. Modultyp:      Importmodul
  484. Autor:         (C) Toastware
  485. Versionsnr:    00.01
  486. Versionsdatum: Apr 27 1994
  487.  
  488.  
  489. Beschreibung
  490.  
  491. Importiert Neochrome(TM) Bilder.
  492.  
  493.  
  494.                                                                PCX.MDL
  495. ----------------------------------------------------------------------
  496.  
  497. Modulname:     PCX.MDL
  498. Modulkennung:  JPCX
  499. Modultyp:      Importmodul
  500. Autor:         John McLoud, Freeware
  501. Versionsnr:    01.02
  502. Versionsdatum: Aug 14 1994
  503.  
  504.  
  505. Beschreibung
  506.  
  507. PCX.MDL importiert Bilder im PCX-Format in Zeig's mir.
  508.  
  509. Erlaubt sind Bilder mit 1, 4, 16 und 256 Farben, sowie 24 Bit
  510. TrueColor-Bilder
  511.  
  512.  
  513.  
  514. Copyright
  515.  
  516. Liegt komplett bei mir!
  517.  
  518.  
  519.                                                              TARGA.MDL
  520. ----------------------------------------------------------------------
  521.  
  522. Modulname:     TARGA.MDL
  523. Modulkennung:  TGAI
  524. Modultyp:      Importmodul
  525. Autor:         Dirk Haun @ WI2, Freeware
  526. Versionsnr:    00.30
  527. Versionsdatum: Aug  6 1994
  528.  
  529.  
  530. Beschreibung
  531.  
  532. Dieses Modul importiert Bilder im Targa-Format (TGA) in Zeig's
  533. mir. Das Modul kennt bisher Bilder mit 2 Farben (monochrom),
  534. Palettenbilder mit bis zu 256 Farben, sowie High-Color- und
  535. True-Color-Bilder (16 bzw. 24 Bit pro Pixel), jeweils ungepackt
  536. oder RLE-gepackt.
  537.  
  538. Die Informationen über das Targa-Format mußte ich mir leider aus
  539. den verschiedensten Quellen zusammensuchen und sind trotzdem noch
  540. nicht vollständig (offenbar existieren auch Formate, die Huffman-
  541. und/oder Delta-komprimiert sind). Für Hinweise auf eine wirklich
  542. umfassende Beschreibung dieses Formats wäre ich sehr dankbar.
  543.  
  544. Die Routinen zum Lesen und Entpacken eines RLE-gepackten Targa-
  545. Bildes basieren zum Teil auf Routinen des P.O.V.-Raytracers,
  546. (C) POV-Team.
  547.  
  548.  
  549.                                                               TIFF.MDL
  550. ----------------------------------------------------------------------
  551.  
  552. Modulname:     TIFF.MDL
  553. Modulkennung:  JTIF
  554. Modultyp:      Importmodul
  555. Autor:         John McLoud, Freeware
  556. Versionsnr:    01.04
  557. Versionsdatum: Aug 14 1994
  558.  
  559.  
  560. Beschreibung
  561.  
  562. TIFF.MDL importiert Bilder im TIFF-Format in Zeig's mir, gemäß
  563. TIFF 5.0 Spezifikation. Es werden 2, 4, 16 und 256 Farben bei
  564. Palettenbildern, 4-, 16- und 256-Graustufenbilder und 24 Bit True-
  565. Colorbilder akzeptiert.
  566.  
  567.  
  568.  
  569. Anmerkungen
  570.  
  571. - Defekte LZW-Bilder stammen meist von Programmen, die einen
  572.   falschen LZW-Code liefern. In dem Fall werden diese Bildteile
  573.   nochmal mit einem geänderten Decoder geladen. Das kostet zwar
  574.   Zeit, bringt aber oft gute Ergebnisse.
  575.  
  576. - Es werden (noch) keine TIFFs nach FAX G III/G IV unterstützt;
  577.   auch RLE-packing ist nicht implementiert. Diese drei Packarten
  578.   sind allerdings auch nur für Monochrome Bilder definiert und
  579.   äußerst selten.
  580.  
  581.  
  582.  
  583. Copyright
  584.  
  585. Die Sourcen sind bis auf eine Ausnahme auf meinem Mist gewachsen.
  586. Diese Ausnhme ist der LZW-Decoder, der auf dem 'Source for
  587. Generalised Bitmap Module' von Andy Key basiert (aber kräftig
  588. geändert wurde).
  589.  
  590.  
  591.                                                               TSWS.MDL
  592. ----------------------------------------------------------------------
  593.  
  594. Modulname:     TSWS.MDL
  595. Modulkennung:  TSWS
  596. Modultyp:      Importmodul
  597. Autor:         Dirk Haun @ WI2, Freeware
  598. Versionsnr:    00.06
  599. Versionsdatum: Aug  6 1994
  600.  
  601.  
  602. Beschreibung
  603.  
  604. Dieses Modul dürfte nur für die wenigsten Menschen von Nutzen sein
  605. (ich dagegen brauche es sehr oft). Es zeigt Dateien, die in meinem
  606. hauseigenen Binärformat vorliegen (kurz: TSWS-Chunk-Format) als
  607. eine Art gegliederter Hexdump an.
  608.  
  609. Wenn es darum geht, Daten zu speichern, für die es noch kein
  610. Standardformat gibt und für die auch eine Speicherung als ASCII
  611. keinen Sinn macht, greife ich für gewöhnlich auf dieses Format
  612. zurück. So z.B. für die Settings meiner Entwicklungsumgebung
  613. Chatwin oder für die gepackten Icondaten des IconMan.
  614.  
  615. Der genaue Aufbau soll hier und jetzt nicht bis ins kleinste
  616. Detail ausgebreitet werden (das dürfte auch kaum jemanden interes-
  617. sieren), aber im Prinzip bestehen die Dateien aus ineinander ge-
  618. schachtelten Blöcken (sogenannten "Chunks"), die alle mit einer
  619. vier Byte langen ASCII-Kennung und einer Längenangabe (ebenfalls
  620. in vier Byte) beginnen. Und genau diese Chunks stellt das Modul
  621. als Hexdump dar, wobei sich die Verschachtelung anhand der Ein-
  622. rückung erkennen läßt.
  623.  
  624.  
  625.                                                               XIMG.MDL
  626. ----------------------------------------------------------------------
  627.  
  628. Modulname:     XIMG.MDL
  629. Modulkennung:  XIMG
  630. Modultyp:      Importmodul
  631. Autor:         Dirk Haun @ WI2, Freeware
  632. Versionsnr:    00.05
  633. Versionsdatum: Aug  6 1994
  634.  
  635.  
  636. Beschreibung
  637.  
  638. Dieses Modul importiert Bilder im XIMG-Format als Farbbilder in
  639. Zeig's mir. XIMG ist die Erweiterung des IMG-Formats um Farb-
  640. informationen. Da Zeig's mir bereits Bilder im monochromen IMG-
  641. Format lesen kann, wäre es nur logisch, daß die XIMG-Funktion
  642. auch selbst in Zeig's mir integriert würde (zumal die hier ver-
  643. wendete Entpackroutine auch monochrome IMGs lesen könnte). Leider
  644. ist der Autor von Zeig's mir da anderer Meinung, weshalb ich mich
  645. gezwungen sah, dieses Modul zu schreiben ...
  646.  
  647. Anmerkung: Das ist nur halb so ernst gemeint, wie es klingt.
  648. Trotzdem verstehe ich nicht, warum der gute Reiner sich sträubt,
  649. zumal es ihn nichts kosten würde (weder Geld noch Speicherplatz
  650. und so gut wie keine Arbeit).
  651.  
  652.  
  653.                                                            ZEIGBLK.MDL
  654. ----------------------------------------------------------------------
  655.  
  656. Modulname:     ZEIGBLK.MDL
  657. Modulkennung:  ZEIGBLK
  658. Modultyp:      Importmodul
  659. Autor:         (c) Reiner Rosin
  660. Versionsnr:    01.10
  661. Versionsdatum: 16. Februar 1994
  662.  
  663.  
  664. Beschreibung
  665.  
  666. Dieses Modul kann wahrscheinlich niemand außer mir gebrauchen.
  667. Man kann damit monochrome Bitblöcke anzeigen, wie sie GFA-Basic
  668.  mit dem GET-Befehl erzeugt.
  669.  
  670.  
  671.                                                            ZEIGDOC.MDL
  672. ----------------------------------------------------------------------
  673.  
  674. Modulname:     ZEIGDOC.MDL
  675. Modulkennung:  ZDOC
  676. Modultyp:      Importmodul
  677. Autor:         Dirk Haun @ WI2, Freeware
  678. Versionsnr:    00.12
  679. Versionsdatum: Aug  6 1994
  680.  
  681.  
  682. Beschreibung
  683.  
  684. Dieses Modul importiert Texte im DOC-Format von 1stWord(plus) als
  685. ASCII-Texte in Zeig's mir. Da Zeig's mir bei Texten nur das reine
  686. ASCII-Format unterstützt, gehen sämtliche Schriftinformationen
  687. (fett, unterstrichen, usw.), Fußnoten und eingebundene Bilder
  688. verloren. Wurde das 1stWord-Dokument im Blocksatz geschrieben, so
  689. bleibt zumindest dieser erhalten.
  690.  
  691.  
  692.                                                            ZEIGFNT.MDL
  693. ----------------------------------------------------------------------
  694.  
  695. Modulname:     ZEIGFNT.MDL
  696. Modulkennung:  ZEIGFNT
  697. Modultyp:      Importmodul
  698. Autor:         (c) Reiner Rosin
  699. Versionsnr:    01.10
  700. Versionsdatum: 16. Februar 1994
  701.  
  702.  
  703. Beschreibung
  704.  
  705. Mit diesem Modul lassen sich Screenfonts im Format 8*16 oder
  706. 8*8 laden. Diese Fonts haben keinen Header (Länge konstant 4096
  707. bzw. 2048 Bytes) und es gibt zwei unterschiedliche Formate: Das
  708. GEM-übliche Format, in dem die Daten quasi als Bitmap mit 2048
  709. Pixeln Breite und 8 resp. 16 Pixel Höhe gespeichert sind und das
  710. von STaD verwendete Format, bei dem alle Zeichen hintereinander
  711. angeordnet sind (quasi 8 Pixel breit und 2048 resp. 4096 Pixel
  712. hoch). Das Modul versucht eine automatische Unterscheidung, die
  713. sogar recht zuverlässig funktioniert.
  714.  
  715.  
  716.                                                            ZEIGPIC.MDL
  717. ----------------------------------------------------------------------
  718.  
  719. Modulname:     ZEIGPIC.MDL
  720. Modulkennung:  ZEIGPIC
  721. Modultyp:      Importmodul
  722. Autor:         (c) Reiner Rosin
  723. Versionsnr:    01.10
  724. Versionsdatum: 16. Februar 1994
  725.  
  726.  
  727. Beschreibung
  728.  
  729. Importmodul für ungepackte Screendumps (Länge konstant 32000
  730. Bytes), auch bekannt als Doodle-Format (DOO).
  731.  
  732.  
  733.                                                            ZEIGSND.MDL
  734. ----------------------------------------------------------------------
  735.  
  736. Modulname:     ZEIGSND.MDL
  737. Modulkennung:  ZSND
  738. Modultyp:      Importmodul
  739. Autor:         Dirk Haun @ WI2, Freeware
  740. Versionsnr:    00.18
  741. Versionsdatum: Aug  6 1994
  742.  
  743.  
  744. Beschreibung
  745.  
  746. Dieses Modul importiert Samples in verschiedenen Formaten in
  747. Zeig's mir. Im einzelnen werden folgende Formate unterstützt:
  748.  
  749.  - Windows WAVE (*.WAV)
  750.  - Creative Voice File (*.VOC)
  751.  - Amiga IFF/8SVX
  752.  - AVR
  753.  - SoundMerlin
  754.  - SoundMachine
  755.  - das Format des Programms DMA_PLAY.PRG
  756.  - ein vom Macintosh stammendes Format
  757.  - einige Formate unbekannter Herkunft (JON, FSSD, V8)
  758.  
  759. Die mir zu diesen Formaten vorliegenden Dokumentationen reichen
  760. von sehr ausführlich (WAV, VOC) über ausreichend (AVR, IFF) bis
  761. zu nicht vorhanden (Mac-SND, JON, FSSD, V8). Das Bestreben war,
  762. möglichst alles abspielen zu können, was auch nur im entferntesten
  763. nach einem Sample aussieht. Bei den nicht dokumentierten Formaten
  764. besteht die Möglichkeit, daß sich einzelne Files nicht richtig
  765. abspielen lassen, da das Dateiformat eben nur geraten ist. Aber
  766. auch bei den gut dokumentierten Formaten sind noch nicht alle
  767. Möglichkeiten berücksichtigt.
  768.  
  769.  
  770.                                                            ZEIGZYX.MDL
  771. ----------------------------------------------------------------------
  772.  
  773. Modulname:     ZEIGZYX.MDL
  774. Modulkennung:  ZEIGZYX
  775. Modultyp:      Importmodul
  776. Autor:         (c) Reiner Rosin
  777. Versionsnr:    01.00
  778. Versionsdatum: 16. Februar 1994
  779.  
  780.  
  781. Beschreibung
  782.  
  783. Importer für Zyxel-Voicefiles. Im Gegensatz zu ADPCM.MDL von
  784. Thorsten kann man hiermit nur die 3-Bit-ADPCM-codierten Dateien
  785. laden. Durch Assemblerprogrammierung ist es dafür aber um etwa
  786. den Faktor 6 schneller.
  787.  
  788.  
  789.                                                            ASCTEST.MDL
  790. ----------------------------------------------------------------------
  791.  
  792. Modulname:     ASCTEST.MDL
  793. Modulkennung:  ASCTEST
  794. Modultyp:      Bearbeitungsmodul ASCII
  795. Autor:         (c) Reiner Rosin
  796. Versionsnr:    01.00
  797. Versionsdatum: 7. September 1993
  798.  
  799.  
  800.  
  801.  
  802.                                                           CHAINSAW.MDL
  803. ----------------------------------------------------------------------
  804.  
  805. Modulname:     CHAINSAW.MDL
  806. Modulkennung:  CHAINSAW
  807. Modultyp:      Bearbeitungsmodul ASCII
  808. Autor:         (c) Toastware
  809. Versionsnr:    00.01
  810. Versionsdatum: 4. Februar 1994
  811.  
  812.  
  813. Beschreibung
  814.  
  815. Chainsaw macht einen Zeilenumbruch bei Asciitexten. Wenn also
  816. ein Text die max. Zeilenlänge 500 hat (z.B. ein blockgesetzter
  817. Text ohne Returns), stellt man z.B. 80 ein und erhält dann einen
  818. Text, den man ohne Probleme lesen kann. Es wird sogar darauf
  819. geachtet, daß kein Wort zersägt wird (es sei denn es ist länger
  820. als die Zeilenlänge).
  821.  
  822.  
  823.                                                               GREP.MDL
  824. ----------------------------------------------------------------------
  825.  
  826. Modulname:     GREP.MDL
  827. Modulkennung:  GREP
  828. Modultyp:      Bearbeitungsmodul ASCII
  829. Autor:         Reiner Rosin
  830. Versionsnr:    01.02
  831. Versionsdatum: Aug 11 1994
  832.  
  833.  
  834. Beschreibung
  835.  
  836. Mit Grep lassen sich in Texten Zeichenketten suchen und der
  837. Bereich um die Fundstelle zeilenweise als neuer Text anlegen.
  838.  
  839. Parameter:
  840. Suchstring         - dürfte klar sein, der zu suchende String
  841. Zeilen vorher      - soviele Zeilen vor der Fundstelle werden
  842.                      kopiert
  843. Zeilen nachher     - soviele Zeilen nach der Fundstelle werden
  844.                      kopiert
  845. Leerzeile trennt Absätze
  846.                    - ist diese Option aktiviert, dann wird vor
  847.                      und nach der Fundstelle nur maximal bis zur
  848.                      nächsten Leerzeile kopiert
  849. Wildcard (nur '?') - mit dieser Option wählt man, ob das
  850.                      Fragezeichen als Wildcard zulässig ist
  851. Groß=Klein         - legt fest, ob Groß-Kleinschreibung unter-
  852.                      schieden werden soll
  853.  
  854.  
  855. Anwendungsbeispiel: Man sucht in einer Maus-Dateiliste alle
  856. Uploads eines bestimmten Users. Als Suchstring gibt man "Von
  857. <Vorname> <Nachname>" ein, setzt die Zeilenlimits auf Maximum
  858. (=9) und wählt "Leerzeile trennt Absätze" --> et voila - da ist
  859. die Liste.
  860.  
  861.  
  862.                                                           TABSPACE.MDL
  863. ----------------------------------------------------------------------
  864.  
  865. Modulname:     TABSPACE.MDL
  866. Modulkennung:  TABSPACE
  867. Modultyp:      Bearbeitungsmodul ASCII
  868. Autor:         (c) Toastware
  869. Versionsnr:    00.02
  870. Versionsdatum: 27.04.1994 
  871.  
  872.  
  873. Beschreibung
  874.  
  875. TABSPACE expandiert die in Texten vorkommenden Tabulatoren und
  876. ersetzt sie durch feste Leerzeichen.
  877.  
  878.  
  879.                                                           UML_WAND.MDL
  880. ----------------------------------------------------------------------
  881.  
  882. Modulname:     UML_WAND.MDL
  883. Modulkennung:  R_UW
  884. Modultyp:      Bearbeitungsmodul ASCII
  885. Autor:         Reiner Rosin
  886. Versionsnr:    00.02
  887. Versionsdatum: Aug  9 1994
  888.  
  889.  
  890. Beschreibung
  891.  
  892. Der Umlautwandler wandelt - wer hätte es gedacht - Umlaute.
  893. Dabei gibt es zwei Möglichkeiten:
  894.  
  895.     a) ä->ae, ö->oe, ü->ue, Ä->Ae, Ö->Oe, Ü->Ue, ß->ss
  896.     b) ä->/"a, ö->/"o, ü->/"u, Ä->/"A, Ö->/"O, Ü->/"U, ß->/"s
  897.  
  898.  
  899.                                                             BITMAP.MDL
  900. ----------------------------------------------------------------------
  901.  
  902. Modulname:     BITMAP.MDL
  903. Modulkennung:  BITMAP
  904. Modultyp:      Bearbeitungsmodul Monochrombilder
  905. Autor:         (c) Reiner Rosin
  906. Versionsnr:    01.20
  907. Versionsdatum: 16. Februar 1994
  908.  
  909.  
  910. Funktion:      BITMAP stellt elementare Operationen zur
  911.                Bearbeitung von monochromen Bildern zur Verfügung
  912.  
  913. Diese Operationen sind:
  914.  
  915. -Halbieren eines Bildes in X- oder Y-Richtung oder beides
  916. -Verdoppeln eines Bildes in X- oder Y- oder beiden Richtungen
  917. -Spiegeln an der vertikalen oder horizontalen Mittellinie
  918.  
  919.  
  920.                                                             FAX300.MDL
  921. ----------------------------------------------------------------------
  922.  
  923. Modulname:     FAX300.MDL
  924. Modulkennung:  FAX300
  925. Modultyp:      Bearbeitungsmodul Monochrombilder
  926. Autor:         (c) Reiner Rosin
  927. Versionsnr:    01.20
  928. Versionsdatum: 16. Februar 1994
  929.  
  930.  
  931. Funktion: Umrechnen von Faxdateien (200*200 oder 200*100 DPI) auf
  932.           Laserdruckerauflösung (300*300 DPI)
  933.  
  934. Beschreibung:
  935.  
  936. Faxe liessen sich bis jetzt nur sehr unbefriedigend von Zeig's
  937. mir ausdrucken. Grund dafür ist die merkwürdige Auflösung, in der
  938. Faxe definitionsgemäß vorliegen: 200*100 bzw. 200*200 DPI
  939. (genaugenommen 198 bzw. 98 DPI). Diese Auflösung wird von keinem
  940. Drucker unterstützt und ist auch nicht mit "glatten" Umrechnungs-
  941. faktoren erreichbar.
  942.  
  943. Mit FAX300 kann man jedoch jetzt Faxe auf das Format 300*300 DPI
  944. umrechnen (für Laser- und Tintenstrahldrucker). Dabei gibt es
  945. zwei Besonderheiten:
  946.  
  947. -Faxe sind ca. 8.7 Zoll breit (1728 Pixel), die Druckbreite von
  948.  Laserdruckern beträgt jedoch i.d.R. nur 8 Zoll, d.h. 8*300 =
  949.  2400 Pixel. Deshalb wird in X-Richtung mit einem krummen Faktor
  950.  von 11/8 gerechnet.
  951.  
  952. -Meist wird eine ganze DIN-A4-Seite gefaxt (29.7 cm = 2340
  953.  Pixel), dazu kommt noch die Stampline. Die Druckhöhe bei Laser-
  954.  druckern ist jedoch nur ~11 Zoll, also 3300 Pixel groß. In der
  955.  Y-Achse wird deshalb eine Skalierung um den Faktor 4/3 vorgenommen.
  956.  
  957. Daraus folgt: In Wirklichkeit beträgt die erzielte Auflösung
  958. nicht 300*300, sondern 272*264 DPI. Wenn Maßhaltigkeit gefragt
  959. ist, ist das natürlich keine gute Lösung, im andern Fall bekommt
  960. man so  wenigstens eine ganze Faxseite auf ein Blatt.
  961.  
  962.  
  963.                                                           INVERTER.MDL
  964. ----------------------------------------------------------------------
  965.  
  966. Modulname:     INVERTER.MDL
  967. Modulkennung:  INVERTER
  968. Modultyp:      Bearbeitungsmodul Monochrombilder
  969. Autor:         (c) Reiner Rosin
  970. Versionsnr:    01.02
  971. Versionsdatum: 16. Februar 1994
  972.  
  973.  
  974. Beschreibung
  975.  
  976. Dieses Modul invertiert Monochrombilder.
  977.  
  978.  
  979.                                                            PIC_CUT.MDL
  980. ----------------------------------------------------------------------
  981.  
  982. Modulname:     PIC_CUT.MDL
  983. Modulkennung:  PIC_CUT
  984. Modultyp:      Bearbeitungsmodul Monochrombilder
  985. Autor:         Reiner Rosin
  986. Versionsnr:    00.01
  987. Versionsdatum: Mar 27 1994
  988.  
  989.  
  990. Funktion: Schneidet die (manchmal) störenden weißen Ränder um
  991.           Bitmaps ab.
  992.  
  993. Einschränkung: Es wird nur byteweise gesucht, also bleibt links
  994.                ein bis zu 7 Pixel breiter Rand übrig, rechts
  995.                wegen des Word-Alignements sogar ein bis zu 15
  996.                 Pixel breiter.
  997.  
  998.  
  999.                                                            PIC_DBL.MDL
  1000. ----------------------------------------------------------------------
  1001.  
  1002. Modulname:     PIC_DBL.MDL
  1003. Modulkennung:  PIC_DBL
  1004. Modultyp:      Bearbeitungsmodul Monochrombilder
  1005. Autor:         Reiner Rosin
  1006. Versionsnr:    00.04
  1007. Versionsdatum: Aug  9 1994
  1008.  
  1009.  
  1010. Beschreibung
  1011.  
  1012. Verdoppelt eine Bitmap in Breite und Höhe. Im Gegensatz zum
  1013. Bitmaptool-Modul wird ein "intelligenter" Algorithmus benutzt,
  1014. der Zwischenpixel berechnet, d.h. es entstehen keine
  1015. Klötzchengrafiken, sondern, soweit möglich, harmonische Bilder.
  1016.  
  1017. Es stehen drei Algorithmen zur Verfügung:
  1018.  
  1019. "Ausdünnen, eckig" - besonders für technische Zeichnungen,
  1020.                      z.B. Schaltpläne geeignet
  1021.  
  1022. "Ausdünnen, rund"  - für gerasterte Bilder geeignet
  1023.  
  1024. "Verdicken"        - für Strichzeichnungen empfehlenswert
  1025.  
  1026.  
  1027.                                                           PIC_TURN.MDL
  1028. ----------------------------------------------------------------------
  1029.  
  1030. Modulname:     PIC_TURN.MDL
  1031. Modulkennung:  PIC_TURN
  1032. Modultyp:      Bearbeitungsmodul Monochrombilder
  1033. Autor:         Reiner Rosin
  1034. Versionsnr:    00.13
  1035. Versionsdatum: Aug  9 1994
  1036.  
  1037.  
  1038. Funktion: Dreht monochrome Bitmapgrafiken um 180 Grad oder um
  1039.           90 Grad nach rechts oder links
  1040.  
  1041.  
  1042.                                                           KOMPRESS.MDL
  1043. ----------------------------------------------------------------------
  1044.  
  1045. Modulname:     KOMPRESS.MDL
  1046. Modulkennung:  KOMPRESS
  1047. Modultyp:      Bearbeitungsmodul Samples
  1048. Autor:         (C) Toastware
  1049. Versionsnr:    00.01
  1050. Versionsdatum: Aug 18 1994
  1051.  
  1052.  
  1053. Beschreibung
  1054.  
  1055. Der Kompressor regelt die Verstärkung von Samples in Abhängigkeit
  1056. von momentaner und _kommender_ Lautstärke.
  1057. Mit den Parametern 'Abkling-' und 'Anklingfaktor' wird die
  1058. Geschwindigkeit der Verstärkungsänderung geregelt. Je größer
  1059. der Wert, desto langsamer. Im optionalen V(t)-Fenster kann man
  1060. sich die daraus entstandene Verstärkung ansehen.
  1061.  
  1062.  
  1063.                                                           SAMPCALC.MDL
  1064. ----------------------------------------------------------------------
  1065.  
  1066. Modulname:     SAMPCALC.MDL
  1067. Modulkennung:  SAMPCALC
  1068. Modultyp:      Bearbeitungsmodul Samples
  1069. Autor:         (c) Reiner Rosin
  1070. Versionsnr:    01.10
  1071. Versionsdatum: 16. Februar 1994
  1072.  
  1073.  
  1074. Dieses Modul beinhaltet zwei Funktionen zur Bearbeitung von
  1075. Samplen:
  1076.  
  1077. 1. Nullage
  1078. Verschiebt die Amplituden linear, so daß die größten Amplituden
  1079. symmetrisch zur Mittellinie liegen (was nicht automatisch
  1080. impliziert, daß auch der Mittelwert aller Samplewerte 0 ergibt).
  1081.  
  1082. 2. Maximale Verstärkung
  1083. Hebt die Lautstärke um den maximal möglichen Faktor an, so daß
  1084. das Signal gerade eben noch nicht verzerrt wird. Sollte im
  1085. eigenen Interesse nicht mehrmals auf das gleiche Sample
  1086. angewendet werden (Rundungsfehler!).
  1087.  
  1088.  
  1089.                                                           SAMPMIRR.MDL
  1090. ----------------------------------------------------------------------
  1091.  
  1092. Modulname:     SAMPMIRR.MDL
  1093. Modulkennung:  SAMPMIRR
  1094. Modultyp:      Bearbeitungsmodul Samples
  1095. Autor:         Reiner Rosin
  1096. Versionsnr:    00.11
  1097. Versionsdatum: Mar 27 1994
  1098.  
  1099.  
  1100. Beschreibung
  1101.  
  1102. Spiegelt ein Sample, d.h. es wird danach rückwärts abgespielt.
  1103.  
  1104.  
  1105.                                                           SOUNDEXP.MDL
  1106. ----------------------------------------------------------------------
  1107.  
  1108. Modulname:     SOUNDEXP.MDL
  1109. Modulkennung:  SNDX
  1110. Modultyp:      Bearbeitungsmodul Samples
  1111. Autor:         Dirk Haun @ WI2, Freeware
  1112. Versionsnr:    00.02
  1113. Versionsdatum: Aug  6 1994
  1114.  
  1115.  
  1116. Beschreibung
  1117.  
  1118. Dieses Modul exportiert 8-Bit-Samples als HSN-Files, wie sie z.B.
  1119. von dem Programm CrazySounds verwendet werden. Die Frequenzen der
  1120. CrazySounds-Samples orientieren sich an den Frequenzen der Atari-
  1121. Rechner mit DMA-Sound-Hardware, deshalb werden die Samples vor dem
  1122. Export nötigenfalls noch in eine der Frequenzen 6258, 12517,
  1123. 25033 oder 50066 Hz umgerechnet (mit Tendenz zur höheren, d.h. ein
  1124. Sample, das mit 22050 Hz vorliegt, wird auf 25033 Hz umgerechnet).
  1125. Beachten Sie bitte, daß die Samples dadurch u.U. länger werden,
  1126. als das Ausgangs-Sample.
  1127.  
  1128. Bedienung: Wählen Sie im Dialog "Bearbeiten" im Popup den Menü-
  1129. punkt "Sample exportieren" und geben Sie im Fileselector den Namen
  1130. des Samples ein (Extension sollte "HSN" sein).
  1131.  
  1132. Die Routine zum Umrechnen auf eine höhere Frequenz stammt von
  1133. Reiner Rosin himself und findet in dieser Form auch schon in
  1134. Zeig's mir Verwendung.
  1135.  
  1136.  
  1137.                                                           GDPSSCAN.MDL
  1138. ----------------------------------------------------------------------
  1139.  
  1140. Modulname:     GDPSSCAN.MDL
  1141. Modulkennung:  R_GS
  1142. Modultyp:      Sourcemodul
  1143. Autor:         Reiner Rosin
  1144. Versionsnr:    00.03
  1145. Versionsdatum: Aug  9 1994
  1146.  
  1147.  
  1148. Beschreibung
  1149.  
  1150. GDPSSCAN sucht einen installierten GDPS-Scannertreiber und
  1151. versucht diesen zur Mitarbeit zu überreden.
  1152.  
  1153. Einschränkungen
  1154. -Getestet wurde es mit einem einzigen Scanner (UMAX UC630) in den
  1155.  Betriebsarten s/w, 256 Graustufen und TrueColor. Da der UMAX-
  1156.  GDPS-Treiber stellenweise stark von der mir vorliegenden GDPS-
  1157.  Beschreibung abweicht, habe ich versucht, die kritischen Punkte
  1158.  möglichst vernünftig geradezubügeln, um sowohl der Spezifikation
  1159.  als auch dem UMAX-Treiber gerecht zu werden.
  1160.  Es kann jetzt allerdings vorkommen, daß z.B. mit 64 Graustufen
  1161.  gescante Bilder oder sonstige Exoten sonderbare Ergebnisse
  1162.  liefern.
  1163.  
  1164.  
  1165. Ich wäre den Besitzer von Scannern mit GDPS-Treibern sehr
  1166. verbunden, wenn sie mir ihre Erfahrungen mit diesem Modul bitte
  1167. mitteilen könnten!
  1168.  
  1169.  
  1170.                                                           SRC_DMAS.MDL
  1171. ----------------------------------------------------------------------
  1172.  
  1173. Modulname:     SRC_DMAS.MDL
  1174. Modulkennung:  SRC_DMAS
  1175. Modultyp:      Sourcemodul
  1176. Autor:         (c) Reiner Rosin
  1177. Versionsnr:    01.00
  1178. Versionsdatum: 20. Februar 1994
  1179.  
  1180.  
  1181. Dieses Modul ist nichts für schwache Nerven. Ängstliche Naturen
  1182. solten es sofort löschen!
  1183.  
  1184. Was macht dieses Modul? Es liest die Frameregister des DMA-Sound-
  1185. chips aus und kopiert den Speicherbereich, auf den diese Register
  1186. zeigen in den Speicher von 'Zeig's mir'.
  1187.  
  1188. Was kann man damit machen? Man stellt so das letzte per DMA-Sound
  1189. gespielte Sample wieder her. Damit kann man z.B. die Aufnahmen
  1190. des Anrufbeantworters von CoNnect konvertieren. CoNnect starten,
  1191. Aufnahme abspielen und sofort (am besten aus dem parallel
  1192. laufenden 'Zeig's mir', d.h. Accessory oder Multitaskingumgebung)
  1193. "DMA-Sample klauen" ausführen.
  1194.  
  1195. Was kann schiefgehen? Einiges! Die gröbsten Fälle fängt das Modul
  1196. ab:
  1197.    - DMA-Sound nicht vorhanden
  1198.    - kapitale Fehler in den Framedaten (Framestart/-ende = 0 oder
  1199.      Ende<Start)
  1200. Trotzdem kann einiges kaputtgehen:
  1201.    - Frameregister zeigen auf ungültige Adresse (Bus-Error!)
  1202.    - Memory-Protection eingeschaltet. Der Bereich, in dem der
  1203.      Frame liegt, gehört nicht unbedingt 'Zeig's mir' (Oft tut er
  1204.      es doch, weil er in dem Bereich liegt, den 'Zeig's mir' für
  1205.      das Modul angefordert hat).
  1206.      Bis jetzt kann das aber nur unter MTOS zu Problemen führen.
  1207.    - Manchmal ist auch der Speicher mittlerweile anderweitig
  1208.      benutzt. Das ist nicht weiter tragisch - dann wird einfach
  1209.      Müll zurückgeliefert.
  1210.  
  1211. ****************************************************************
  1212.  
  1213. Obacht also, SRC_DMAS ist ein Schweinemodul! Da es sowieso nicht
  1214. sonderlich nützlich ist, wird man's aber nicht oft brauchen. Und
  1215. wenn man's dann doch einmal einsetzt, vielleicht vorher besser
  1216. doch alle Dokumente in Calamus, Tempus Write usw. schließen...
  1217.  
  1218. Solange es nicht gestartet wird, ist es übrigens völlig
  1219. unschädlich. Man kann's also beruhigt im Modulordner lassen.
  1220.  
  1221. ****************************************************************
  1222.  
  1223.  
  1224.                                                           SRC_SCRN.MDL
  1225. ----------------------------------------------------------------------
  1226.  
  1227. Modulname:     SRC_SCRN.MDL
  1228. Modulkennung:  SRC_SCRN
  1229. Modultyp:      Sourcemodul
  1230. Autor:         (c) Reiner Rosin
  1231. Versionsnr:    01.00
  1232. Versionsdatum: 20. Februar 1994
  1233.  
  1234.  
  1235. Beschreibung
  1236.  
  1237. Hiermit kann der aktuelle Bildschirminhalt gegrabbed werden.
  1238. Vielleicht kann's ja in dem einen oder anderen Fall eine
  1239. Hardcopy ersetzen - man weiß ja nie.
  1240.  
  1241.  
  1242. Risiken und Nebenwirkungen:
  1243.  
  1244. -Das Modul arbeitet nur auf monochromen Bildschirmen, da
  1245.  'Zeig's mir' zum Zeitpunkt der Modulerstellung noch keine
  1246.  Farbbilder verarbeiten konnte. Wird evtl. noch geändert.
  1247.  
  1248. -Der Bildspeicher muß im Adressraum eingeblendet sein, d.h.
  1249.  Physbase eine gültige Adresse liefern (einige Grafikkarten
  1250.  scheiden also aus)
  1251.  
  1252. -Das Modul ruft LineA auf, um die physikalische und logische
  1253.  Bildschirmbreite zu ermitteln. Das dürfte akzeptabel sein - es
  1254.  wird nur lesend zugegriffen.
  1255.  
  1256. -Die Dialogbox zur Funktionsauswahl wird evtl. vor dem Funktions-
  1257.  aufruf nicht vom Bildschirm gelöscht. Abhilfe: Box auf einen
  1258.  freien Bildbereich schieben  oder aus dem Bildschirm heraus und
  1259.  mit [Return] auslösen.
  1260.  
  1261. -Gleiches gilt für den Mauszeiger. Am besten in eine Bildecke
  1262.  schieben.
  1263.  
  1264.  
  1265.                                                           BRIGHTEN.MDL
  1266. ----------------------------------------------------------------------
  1267.  
  1268. Modulname:     BRIGHTEN.MDL
  1269. Modulkennung:  BRIG
  1270. Modultyp:      Bearbeitungsmodul Farbbilder
  1271. Autor:         Dirk Haun @ WI2, Freeware
  1272. Versionsnr:    00.02
  1273. Versionsdatum: Aug  6 1994
  1274.  
  1275.  
  1276. Beschreibung
  1277.  
  1278. Mit diesem Modul kann die Helligkeit von Farbbildern verändert
  1279. werden. Im Dialog "Bearbeiten" können Sie dazu zwischen mehreren
  1280. vorgegebenen Werten (jeweils 5, 25 oder 33 Prozent aufhellen oder
  1281. abdunkeln) wählen. Klicken Sie dagegen den Punkt "Helligkeit
  1282. wählen" an, so können Sie in einem Dialog den Prozentwert selbst
  1283. eingeben (Werte von 1 bis 99, ein Wert "0 Prozent" ist unsinnig
  1284. und wird abgelehnt). Klicken Sie dann, je nach gewünschter Funk-
  1285. tion, auf einen der Buttons "aufhellen" oder "abdunkeln". Haben
  1286. Sie es sich anders überlegt, so können Sie den Dialog auch mit
  1287. "Abbruch" abbrechen, das Bild wird dann nicht verändert.
  1288.  
  1289. Für technisch interessierte Mitmenschen: Das Modul rechnet die in
  1290. RGB-Werten vorliegenden Bildinformationen ins YIQ-Farbmodell um
  1291. (wobei Y die Helligkeit und I und Q Farbinformationen sind). Dort
  1292. werden dann die Y-Werte um die angegebene Prozentzahl erhöht oder
  1293. erniedrigt und anschließend wieder ins RGB-Modell zurück über-
  1294. führt.
  1295.  
  1296. Das YIQ-Farbmodell wird z.B. vom amerikanischen NTSC-Fernsehstan-
  1297. dard verwendet. Nähere Informationen hierzu finden sich
  1298. (natürlich :-) in
  1299.  
  1300.    "Computer Graphics - Principles and Practice"
  1301.    Foley, van Dam, Feiner, Hughes
  1302.    Addison-Wesley, 1990
  1303.    ISBN  0-201-12110-7
  1304.  
  1305.  
  1306.                                                           COL_FUNC.MDL
  1307. ----------------------------------------------------------------------
  1308.  
  1309. Modulname:     COL_FUNC.MDL
  1310. Modulkennung:  R_CF
  1311. Modultyp:      Bearbeitungsmodul Farbbilder
  1312. Autor:         Reiner Rosin
  1313. Versionsnr:    00.04
  1314. Versionsdatum: Aug  9 1994
  1315.  
  1316.  
  1317. Funktion: Soll einmal eine Sammlung elementarer Operationen für
  1318.           Farbbilder werden. Als erstes ist einmal das Verdoppeln
  1319.           von Bildern implementiert.
  1320.  
  1321.  
  1322. Bild verdoppeln 1: Verdoppelt ein Bild, indem es Zwischenpixel
  1323.                    und Zwischenzeilen interpoliert. Das Zielbild
  1324.                    wird grundsätzlich in True-Color abgelegt, was
  1325.                    zum einen einen hohen Speicherbedarf, zum
  1326.                    anderen ggfs. weitere Raster- und Ditherungs-
  1327.                    schritte nötig macht.
  1328.                    Die Interpolation bewirkt ein Aufweichen der
  1329.                    Konturen, verhindert aber die
  1330.                    Blöckchenbildung.
  1331.  
  1332. Bild verdoppeln 2: Verdoppelt das Bild, indem jeder Pixel auf
  1333.                    seine vierfache Größe (doppelte Höhe und
  1334.                    Breite) umgerechnet wird.
  1335.  
  1336.  
  1337.                                                           COL_INFO.MDL
  1338. ----------------------------------------------------------------------
  1339.  
  1340. Modulname:     COL_INFO.MDL
  1341. Modulkennung:  R_CI
  1342. Modultyp:      Bearbeitungsmodul Farbbilder
  1343. Autor:         Reiner Rosin
  1344. Versionsnr:    00.04
  1345. Versionsdatum: Aug  9 1994
  1346.  
  1347.  
  1348. Funktion: COL_INFO wertet Palettenbilder aus und zählt die
  1349.           einzelnen Farben.  Das Ergebnis kann als Infotext
  1350.           oder graphisch dargestellt werden.
  1351.  
  1352. Modulfunktionen:
  1353.           -"Farben zählen" zählt die vorkommenden Farben und
  1354.             gibt deren Anzahl sowie den untern und oberen Index
  1355.             in Textform aus
  1356.  
  1357.           -"Histogramm (s/w)" zeichnet ein Histogramm, d.h. eine
  1358.            Häufigkeitsverteilung (X-Achse: Farbindizes, Y:
  1359.            Häufigkeit)
  1360.  
  1361.           -"Histogramm farbig" tut das gleiche, nur sind die
  1362.             Säulen in der jeweiligen Farbe eingefärbt
  1363.  
  1364.           -"Häufigkeitstabelle" erstellt eine Tabelle in ASCII-
  1365.            Form, d.h. zu jedem Farbindex wird die Anzahl der
  1366.            Pixel angegeben, mit der diese Farbe im Bild vorkommt
  1367.  
  1368.           -"Palette zeichnen" fertigt eine Farbtafel an, die
  1369.            alle im Bild vorkommenden Farben enthält
  1370.  
  1371. Einschränkungen:
  1372.           -COL_INFO arbeitet nur in Auflösungen mit 16 oder 256
  1373.            Farben (Palettenbilder halt)
  1374.  
  1375.  
  1376.                                                           MAULWURF.MDL
  1377. ----------------------------------------------------------------------
  1378.  
  1379. Modulname:     MAULWURF.MDL
  1380. Modulkennung:  R_MW
  1381. Modultyp:      Bearbeitungsmodul Farbbilder
  1382. Autor:         Reiner Rosin
  1383. Versionsnr:    00.03
  1384. Versionsdatum: Aug  9 1994
  1385.  
  1386.  
  1387. Beschreibung
  1388.  
  1389. Wer kennt es nicht, da sitzt man gerade am Rechner und betrachtet
  1390. sich ein wunderschönes Landschafts-GIF. "Oh, Ahh, schöööön,
  1391. dieser wundervoll blaue Himmel, diese leuchtendgelbe Sonne,
  1392. diese saftig grüne Wiese, ..." und bumm - wieder eine Randgruppe
  1393. diskrimniert. Denn nicht für jeden ist grün gleich grün und rot
  1394. gleich rot, es gibt auch farbenblinde Mitbürger!
  1395.  
  1396. "Na und, da kann man nichts machen, was kann GEM-View schon
  1397. dafür?" Ha! Erstens geht's hier nicht um GEM-View, sondern um
  1398. 'Zeig's mir', und zweitens kann 'Zeig's mir' da selbst-
  1399. verständlich was machen. Und zwar Rot und Grün vertauschen, so
  1400. daß auch farbenblinde Lonsheim-Maulwürfe endlich echte True-
  1401. Color-Farben zu sehen bekommen.
  1402.  
  1403.  
  1404.                                                           NOBORDER.MDL
  1405. ----------------------------------------------------------------------
  1406.  
  1407. Modulname:     NOBORDER.MDL
  1408. Modulkennung:  NOBO
  1409. Modultyp:      Bearbeitungsmodul Farbbilder
  1410. Autor:         Dirk Haun @ WI2, Freeware
  1411. Versionsnr:    00.01
  1412. Versionsdatum: Aug 11 1994
  1413.  
  1414.  
  1415. Beschreibung
  1416.  
  1417. Mit diesem Modul kann man einfarbige Ränder von Farbbildern ent-
  1418. fernen lassen (z.Z. nur bei Bildern mit 256 Farben). Dabei kann
  1419. man wählen, ob die Ränder an allen vier Seiten abgeschnitten
  1420. werden sollen (Funktion "Weg mit dem Rand!"), oder ob nur ein Rand
  1421. (oben, unten, links oder rechts) entfernt werden soll.
  1422.  
  1423. Wenn das Modul einmal nicht den gewünschten Effekt zeitigt, dann
  1424. liegt dies daran, daß der Rand wohl doch nicht so einfarbig ist,
  1425. wie es den Anschein hat. Ein einzelner Pixel in einer anderen
  1426. Farbe oder ein Rand, der aus zwei ähnlichen Farbtönen besteht,
  1427. hindert das Modul erfolgreich an seiner Arbeit. Solche Fälle kann
  1428. man aufdecken, indem man mit dem Kontrollfeld einmal probehalber
  1429. die Farben verstellt.
  1430.  
  1431. Die Funktionen "Rand suchen" suchen von den Bildrändern her nach
  1432. durchgehenden einfarbigen Linien und schneiden, sofern sie fündig
  1433. geworden sind, dann dort ab. Dabei wird maximal ein Drittel der
  1434. Bildbreite bzw. -höhe (vom jeweiligen Rand her) durchsucht.
  1435.  
  1436. Durch mehrfaches Anwenden der beiden Möglichkeiten können die
  1437. meisten Bilder von störenden Rändern (und evtl. "Verzierungen"
  1438. wie Mailbox-Logos) befreit werden.
  1439.  
  1440.  
  1441.                                                            PIC2ASC.MDL
  1442. ----------------------------------------------------------------------
  1443.  
  1444. Modulname:     PIC2ASC.MDL
  1445. Modulkennung:  R_PA
  1446. Modultyp:      Bearbeitungsmodul Farbbilder
  1447. Autor:         Reiner Rosin
  1448. Versionsnr:    00.02
  1449. Versionsdatum: Jul  5 1994
  1450.  
  1451.  
  1452. Beschreibung
  1453.  
  1454. Wandelt ein Farbbild in einen ASCII-Text um. Dazu wird das Bild
  1455. in kleine Rechtecke einstellbarer Größe aufgeteilt und für jedes
  1456. dieser Rechtecke die Helligkeit bestimmt. Durch Setzen eines
  1457. geeigneten Zeichens entsteht in dem erzeugten Text mit etwas
  1458. Phantasie ein Abbild des Originals.
  1459.  
  1460.  
  1461.                                                           TARGAEXP.MDL
  1462. ----------------------------------------------------------------------
  1463.  
  1464. Modulname:     TARGAEXP.MDL
  1465. Modulkennung:  TGAX
  1466. Modultyp:      Bearbeitungsmodul Farbbilder
  1467. Autor:         Dirk Haun @ WI2, Freeware
  1468. Versionsnr:    00.03
  1469. Versionsdatum: Aug 13 1994
  1470.  
  1471.  
  1472. Beschreibung
  1473.  
  1474. Dieses Modul exportiert ein Farbbild als Bild im ungepackten
  1475. Targa-Format (TGA). Das Modul wird dazu im Dialog "Bearbeiten"
  1476. über den Popup-Eintrag "Targa-Bild speichern" angewählt. Es
  1477. erscheint ein Fileselector, in dem Sie den Namen des Bildes
  1478. angeben können.
  1479.  
  1480. Hinweise: High-Color-Bilder (16 Bit pro Pixel) werden z.Z. als
  1481. True-Color-Bilder (24 Bit pro Pixel) gespeichert. Monochrome
  1482. Bilder werden nicht unterstützt.
  1483.  
  1484.  
  1485.                                                           ELIMINAT.MDL
  1486. ----------------------------------------------------------------------
  1487.  
  1488. Modulname:     ELIMINAT.MDL
  1489. Modulkennung:  R_EL
  1490. Modultyp:      Dithermodul
  1491. Autor:         Reiner Rosin
  1492. Versionsnr:    00.01
  1493. Versionsdatum: Jul 28 1994
  1494.  
  1495.  
  1496. Funktion:    Der Eliminator reduziert 256-Farbbilder auf 240 oder
  1497.              14 Farben, indem er einzelne Farben auslöscht. Wie
  1498.              jedes hirnlose Muskelpaket vergreift sich auch diese
  1499.              Kampfmaschine an den kleinsten und schwächsten, will
  1500.              sagen an den Farben, die im Bild am seltensten
  1501.              vorkommen.
  1502.  
  1503. Algorithmus: Solange die Farbanzahl über dem Maximum liegt, wird
  1504.              die am seltensten vorkommende Farbe bestimmt und
  1505.              diese durch die ähnlichste, bereits im Bild
  1506.              vorkommende ersetzt.
  1507.  
  1508.              Die Suche nach der ähnlichsten Farbe geschieht über
  1509.              die RGB-Werte, wobei als Abstand zweier Farben das
  1510.              Produkt der Differenzen des R-, G-, und B-Wertes
  1511.              gebildet wird. Vor der Multiplikation wird auf jede
  1512.              Differenz noch ein konstanter Wert aufaddiert (sonst
  1513.              würden Farbpaare, die sich in einem Wert nur gering
  1514.              unterscheiden bevorzugt).
  1515.  
  1516.              Der Farbwert für die zugeordnete Farbe wird dann
  1517.              noch geringfügig an die eliminierte Farbe angepaßt.
  1518.  
  1519. Ergebnis:    Bei 256 Farben arbeitet das Verfahren im allgemeinen
  1520.              recht brauchbar, es müssen im Extremfall auch nur 16
  1521.              Farben eliminiert werden (meistens sind es weniger).
  1522.              Da nur die am wenigsten vorkommenden Farben raus-
  1523.              fliegen, sind die Farbverfälschungen im Normalfall
  1524.              kaum wahrnehmbar. Es sind aber auch Bilder denkbar,
  1525.              bei denen es total daneben geht.
  1526.  
  1527.              Unter 16 Farben sieht's da schon ganz anders aus.
  1528.              Hier muß der Eliminator meist kräftig aufräumen, was
  1529.              an den Bildern schon schmerzliche Verluste erkennen
  1530.              läßt. Die Ergebnisse sind aber auf jeden Fall besser
  1531.              als z.B. die mit PALFIX erzeugten. Ich denke mal,
  1532.              daß sich mit vertretbarem Aufwand und ohne Dithern
  1533.              kein sehr viel besseres Resultat erzielen läßt.
  1534.  
  1535.  
  1536.                                                           HTDITHER.MDL
  1537. ----------------------------------------------------------------------
  1538.  
  1539. Modulname:     HTDITHER.MDL
  1540. Modulkennung:  HDIT
  1541. Modultyp:      Dithermodul
  1542. Autor:         Dirk Haun @ WI2, Freeware
  1543. Versionsnr:    00.15
  1544. Versionsdatum: Jul 29 1994
  1545.  
  1546.  
  1547. Zweck  : Farbbilder nach Monochrom wandeln,
  1548.          Algorithmus: Halftone-Dithering
  1549.  
  1550.  
  1551. Beschreibung
  1552.  
  1553. Dieses Modul wandelt Farbbilder in Monochrombilder. Als Algo-
  1554. rithmus kommt dabei das sogenannte Halftone-Dithering zum
  1555. Einsatz.
  1556.  
  1557. Konkret können Sie zwischen zwei Möglichkeiten wählen:
  1558.  
  1559. "Halftone 1:1"
  1560.    Trotz Verwendung einer 3x3-Matrix wird jeder Pixel des
  1561.    Farbbildes auf einen Pixel des Monochrombildes abgebildet. Die
  1562.    Größe des Bildes bleibt also unverändert.
  1563.  
  1564. "Halftone 1 -> 3x3"
  1565.    Hierbei wird jeder Pixel des Originalbildes auf eine 3x3 Pixel
  1566.    große Matrix im Monochrombild abgebildet. Das Bild wird also
  1567.    dreimal so hoch und dreimal so breit.
  1568.  
  1569. Bilder, die "halftone-gedithert" sind, kennen Sie sicher aus der
  1570. Tageszeitung. Eine sinnvolle Anwednung des Algorithmus ist,
  1571. Farbbilder so aufzubereiten, daß Sie auf einem Ausgabemedium
  1572. wiedergegeben werden können, das nur die Farben Schwarz und Weiß
  1573. unterstützt. Dabei ist insbesondere an Geräte mit hoher Auflösung
  1574. gedacht, also beispielsweise Drucker. Die zweite Möglichkeit, bei
  1575. der je ein Pixel auf eine 3x3-Matrix abgebildet wird, mag zwar
  1576. auf dem Monitor nicht sehr beeindruckend erscheinen, liefert aber
  1577. auf einem Drucker mit 300 oder 360 dpi recht gute Resultate.
  1578.  
  1579. Auf dem Bildschirm liefert Halftone-Dithering meist recht
  1580. unansehnliche Ergebnisse. Gerade die 1:1-Abbildung ist eigentlich
  1581. nur dann von Interesse, wenn kein anderer Ditheralgorithmus zur
  1582. Verfügung steht, da sie recht grob gerasterte Bilder liefert.
  1583.  
  1584. Für nähere Informationen zum Halftone-Dithering sei wieder einmal
  1585. verwiesen auf
  1586.  
  1587.    "Computer Graphics - Principles and Practice"
  1588.    Foley, van Dam, Feiner, Hughes
  1589.    Addison-Wesley, 1990
  1590.    ISBN  0-201-12110-7
  1591.  
  1592.  
  1593.                                                           IGOR_DIT.MDL
  1594. ----------------------------------------------------------------------
  1595.  
  1596. Modulname:     IGOR_DIT.MDL
  1597. Modulkennung:  TDit
  1598. Modultyp:      Dithermodul
  1599. Autor:         (C) Toastware
  1600. Versionsnr:    00.0C
  1601. Versionsdatum: Aug 11 1994
  1602.  
  1603.  
  1604. Beschreibung
  1605.  
  1606. Dieses Modul enthält verschiedene, z.T. sehr gute Ergebnisse
  1607. liefernde Ditheralgorithmen.
  1608.  
  1609. Floyd/Steinberg:
  1610. Der Fehler, der durch die Differenz zwischen darstellbarer und
  1611. gewollter Farbe/Helligkeit entsteht, wird auf die umliegenden
  1612. Pixel verteilt. Dadurch entsteht aus normaler Betrachtungs-
  1613. entfernung der Eindruck eines kontinuierlichen Farb-/Helligkeits-
  1614. verlaufs.
  1615.  
  1616. Mapping:
  1617. Die gewollte Farbe wird soweit 'verbogen', bis sie in die
  1618. vorgegebene Palette passt. Das geht zwar schnell, sieht aber auch
  1619. so aus, es entstehen mitunter eklige Farb-/Helligkeitstreppen.
  1620.  
  1621.  
  1622.                                                            MED_CUT.MDL
  1623. ----------------------------------------------------------------------
  1624.  
  1625. Modulname:     MED_CUT.MDL
  1626. Modulkennung:  R_MC
  1627. Modultyp:      Dithermodul
  1628. Autor:         Reiner Rosin
  1629. Versionsnr:    00.03
  1630. Versionsdatum: Aug 11 1994
  1631.  
  1632.  
  1633. Beschreibung
  1634. Mit MED_CUT lassen sich True-Color und High-Color-Bilder nach
  1635. 16 oder 256 Farben wandeln. Verwendung findet der Algorithmus
  1636. Median-Cut, der dem Modul auch gleich den Namen gegeben hat.
  1637.  
  1638. Algorithmus
  1639. Die im Bild vorkommenden Farben werden zunächst in einem RGB-
  1640. Würfel angeordnet, dessen Seitenlängen anschließend minimiert
  1641. werden, so daß er gerade noch alle vorkommenden Farben
  1642. umschließt. Der enstehende Quader wird dann an seiner längsten
  1643. Seite so  geschnitten, daß in beiden entstehenden Teilquadern
  1644. die Punktmengen möglichst gleich groß sind. Beide Quader werden
  1645. danach  wieder wie beschrieben minimiert und danach der Quader
  1646. mit der größten Seitenlänge weiter geteilt. Dies wird so lange
  1647. wiederholt, bis die Anzahl der Quader der Zahl der gewünschten
  1648. Farben entspricht. Jedem Quader wird anschließend eine Farbe
  1649. zugeordnet und alle Punkte innerhalb des Quaders werden mit
  1650. dieser Farbe dargestellt.
  1651.  
  1652. Umsetzung
  1653. Das Modul reduziert den Farbraum zunächst auf 32768 Farben, damit
  1654. Rechenzeit und Speicherbedarf (zur Laufzeit werden ca. 130 KB
  1655. benötigt) in einem vernünftigen Rahmen bleiben. Die Reduktion
  1656. der Farbquader erfolgt dann wie oben beschrieben, zur Zuordnung
  1657. der Quaderfarbe wird anschließend der gewichtere Mittelwert der
  1658. aus enthaltenen Farben und deren Häufigkeit gebildet.
  1659. Im 256-Farbmodus belegt MED-CUT 240 Farbregister, im 16-Farbmodus
  1660. deren 14.
  1661.  
  1662. Ergebnis
  1663. Die Rechengeschwindigkeit ist etwa doppelt so hoch wie bei
  1664. Thorstens Floyd-Steinberg-Ditherern. Im 256-Farbmodus sind die
  1665. Ergebnisse bei fast allen Bildern ansehnlich bis sehr gut, bei
  1666. einigen läßt sich aber mit der Floyd-Steinberg-Ditherung noch
  1667. etwas mehr herausholen. Im 16-Farbmodus sind dagegen einige
  1668. Abstriche mehr zu machen, das Ergebnis ist sowohl in puncto
  1669. Geschwindigkeit als auch Qualität ein Kompromiß zwischen Dithern
  1670. und der festen Farbzuordnung durch Mapping.
  1671. Nachteil des Verfahrens ist mit Sicherheit der große Speicher-
  1672. bedarf.
  1673.  
  1674. Literatur
  1675. So ein tolles Buch wie Dirk habe ich nicht, die Idee und die
  1676. Grundlage für MED_CUT stammen aus der ST-Computer 7/8-94, S.87ff.
  1677.  
  1678.  
  1679.                                                           PAL_SORT.MDL
  1680. ----------------------------------------------------------------------
  1681.  
  1682. Modulname:     PAL_SORT.MDL
  1683. Modulkennung:  R_PS
  1684. Modultyp:      Dithermodul
  1685. Autor:         Reiner Rosin
  1686. Versionsnr:    00.01
  1687. Versionsdatum: Aug 11 1994
  1688.  
  1689.  
  1690. Farbreduktionsmodul "Paletten-Sortierer"
  1691.  
  1692.  
  1693. Beschreibung
  1694. Dieses Modul sortiert bei Palettenbildern die Farben nach
  1695. Helligkeit. Wozu das gut sein soll? Keine Ahnung, aber als
  1696. angenehmer Nebeneffekt wird die "Luft" aus den Bildern gelassen,
  1697. d.h. nicht verwendete Indizes entfernt und bei Bildern mit
  1698. echten 256 Farben bleiben diese erhalten und werden dabei sogar
  1699. noch so sortiert, daß Farbe 0 die hellste ist und Farbe 255
  1700. die dunkelste. Außerdem wird vielleicht die Histogrammfunktion
  1701. von COL_INFO etwas aussagekräftiger, wenn man die Farben vorher
  1702. mit PAL_SORT sortieren läßt.
  1703.  
  1704.  
  1705.                                                              RAMBO.MDL
  1706. ----------------------------------------------------------------------
  1707.  
  1708. Modulname:     RAMBO.MDL
  1709. Modulkennung:  R_RA
  1710. Modultyp:      Dithermodul
  1711. Autor:         Reiner Rosin
  1712. Versionsnr:    00.01
  1713. Versionsdatum: Jul 29 1994
  1714.  
  1715.  
  1716. Der Eliminator hat einen Bruder bekommen...
  1717.  
  1718. Funktion: Rambo reduziert 256-Farbbilder auf 120 oder 14 Farben,
  1719.           ist aber eigentlich mehr als Juxmodul gedacht
  1720.  
  1721.  
  1722. Algorithmus: Siehe Beschreibung zum Eliminator. Im Gegensatz zum
  1723. Eliminator ist Rambo noch um einiges brutaler und legt sich auch
  1724. mit den stärkeren Kalibern an - die Auswahl der zu eliminierenden
  1725. Farben erfolgt nach dem Zufallsprinzip. Da kann's auch schon mal
  1726. die eine oder andere Farbe erwischen, die etwas zahlreicher im
  1727. Bild vertreten ist.
  1728. Damit der gewünschte Effekt, ein möglichst interessantes Ergebnis
  1729. zu erzielen, auch unter 256 Farben erzielt wird, reduziert Rambo
  1730. hier nicht auf 240, sondern auf 120 Farben.
  1731.  
  1732.  
  1733.                                                             REDUCE.MDL
  1734. ----------------------------------------------------------------------
  1735.  
  1736. Modulname:     REDUCE.MDL
  1737. Modulkennung:  R240
  1738. Modultyp:      Dithermodul
  1739. Autor:         Dirk Haun @ WI2, Freeware
  1740. Versionsnr:    00.12
  1741. Versionsdatum: Aug 14 1994
  1742.  
  1743.  
  1744. Beschreibung
  1745.  
  1746. Dieses Modul reduziert die Farben in Palettenbildern mit 256
  1747. Farben auf maximal 240. Dies ist sinnvoll, damit Zeig's mir bei
  1748. solchen Bildern die 16 Standard-VDI-Farben nicht zu verstellen
  1749. braucht.
  1750.  
  1751. Vorgehensweise: Das Modul eliminiert zunächst Farben aus der
  1752. Farbpalette, die im Bild gar nicht verwendet werden. Anschließend
  1753. werden identische Farben, d.h. Farben, die in der Palette mehrfach
  1754. vorkommen, zusammengelegt.
  1755.  
  1756. Bis hierhin war der Vorgang verlustfrei. Sollten nun noch mehr
  1757. als 240 Farben vorliegen, so nimmt das Modul nunmehr Verluste in
  1758. Kauf. Die Farben der Palette werden zunächst vom RGB- ins HSV-
  1759. Farbmodell überführt, in dem sich Farbähnlichkeiten leichter
  1760. auffinden lassen. Dort wird nun, bei steigender Ungenauigkeit,
  1761. versucht, Farben als "ähnlich" zusammenzufassen. Der Vorgang wird
  1762. sofort abgebrochen, sobald 240 Farben erreicht sind. Nun werden
  1763. die verbliebenen Farben zurück ins RGB-Modell überführt und an
  1764. Zeig's mir weitergereicht.
  1765.  
  1766. Für nähere Informationen über das HSV-Farbmodell sei verwiesen auf
  1767.  
  1768.    "Computer Graphics - Principles and Practice"
  1769.    Foley, van Dam, Feiner, Hughes
  1770.    Addison-Wesley, 1990
  1771.    ISBN  0-201-12110-7
  1772.  
  1773.  
  1774.                                                           TINYDITH.MDL
  1775. ----------------------------------------------------------------------
  1776.  
  1777. Modulname:     TINYDITH.MDL
  1778. Modulkennung:  R_TD
  1779. Modultyp:      Dithermodul
  1780. Autor:         Reiner Rosin
  1781. Versionsnr:    00.05
  1782. Versionsdatum: Aug  3 1994
  1783.  
  1784.  
  1785. Beschreibung
  1786.  
  1787. TINYDITH enthält fünf Dithermethoden, von denen aber keine
  1788. besonders gute Ergebnisse liefert. Das Modul ist im wesentlichen
  1789. dazu gedacht, potentiellen Modulautoren als Grundlage für eigene
  1790. Entwicklungen zu dienen. Die Algorithmen im einzelnen:
  1791.  
  1792. 1. Schwellwertalgorithmus (für monochrome Bildschirme)
  1793. Wandelt Farb- (genauer: Graustufen-) Bilder nach monochrom. Alle
  1794. Pixel, deren Helligkeit einen gewissen Schwellwert
  1795. unterschreiten, werden schwarz gesetzt, alle anderen dagegen
  1796. weiß. Diese Methode ist dreimal integriert mit unterschiedlichen
  1797.  Schwellwerten.
  1798.  
  1799. 2. Graustufenwandlung (für Bildschirme mit 16/256 Farben)
  1800. Wandelt das Bild (bzw. die Palette) nach Graustufen um. Dabei
  1801. werden 16 oder 240 Graustufen benutzt.
  1802.  
  1803. 3. PALFIX (für Bildschirme mit 16/256 Farben)
  1804. Preßt Farbbilder stur mathematisch in eine fest vorgegebene
  1805. Palette mit 16 bzw. 216 Farben.  Fehlerkorrektur, Rasterung oder
  1806. Ditherung wird nicht vorgenommen.
  1807. Je Farbe stehen 6 Abstufungen (0..5) zur Verfügung (bei 256
  1808. Farben) bzw. 2 Abstufen (0 und 1) für Rot und Blau und 4
  1809. Abstufungen (0..3) für Grün (bei 16 Farben).
  1810.  
  1811. 4. Halbton, 5 Graustufen für monochrome Auflösungen
  1812. Ich weiß nicht, ob diese Bezeichnung richtig ist, jedenfalls
  1813. werden Bilder damit mit einer 2*2-Matrix umgesetzt nach
  1814. monochrom.
  1815.  
  1816. 5. Spardither für monochrome Auflösungen
  1817. Dies ist eine abgespeckte Version des Algorithmus von Floyd-
  1818. Steinberg. Statt die Ditherfehler nach rechts und nach unten zu
  1819. verteilen, verteilt der Sparditherer die Fehler nur in
  1820. X-Richtung.
  1821. Besondere Kennzeichen: schnell (25 Zeilen Assemler), Qualität:
  1822. naja.
  1823.  
  1824. ----------------------------------------------------------------------
  1825.                                                                  -eof-
  1826.